home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / vpix18.zip / VIEWPIX.DOC < prev    next >
Text File  |  1992-02-15  |  9KB  |  184 lines
  1.  
  2.  
  3.                    VIEWPIX - Online GIF File Viewing Door
  4.                 Copyright (C) 1991 No Anchovies - Frank Capo
  5.                             All Rights Reserved
  6.  
  7.  
  8.     --------
  9.     Overview
  10.     --------
  11.         VIEWPIX is a BBS door designed to allow your users to preview GIF
  12.     graphics online.  VIEWPIX works in conjuction with GIFDesk - a freeware
  13.     utility written by Jay Wherley, and SHOWGIF - a shareware utility written
  14.     by Bill Parquet.  Both GIFDesk and SHOWGIF are excellent programs in their
  15.     own right and you are urged to spread the word about them.
  16.  
  17.  
  18.     ------------
  19.     Installation
  20.     ------------
  21.                             ***** IMPORTANT *****
  22.  
  23.         It is VITAL to this door's operation that you include a line in your
  24.     AUTOEXEC.BAT file that looks like this:
  25.  
  26.                               SET GIFDESK=FILE
  27.  
  28.         Included in the VIEWPIX package are VIEWPIX.EXE, GIFDSK40.ZIP,
  29.     SHGIF55C.ZIP, SAMPLE.LST, SAMPLE.DIR, SAMPLE.CNF, and VIEWPIXG.  Put the
  30.     SHGIF55C.ZIP aside for now - unpack all the rest to a subdirectory on your
  31.     BBS drive.  Multi-node systems must do the same for each node.
  32.  
  33.         Edit SAMPLE.CNF to conform to the following:
  34.  
  35.     c:\gap                  <- Drive\path to DOOR.SYS (or other "door" file)
  36.     No Anchovies PC         <- The name of your BBS
  37.     GAP                     <- Type of BBS software (see Note below)
  38.     0000                    <- Serial Number (for registered version)
  39.     c:\viewpix\sample.lst   <- Fully qualified drive\path\filename (see below)
  40.     c:\viewpix\sample.dir   <- Fully qualified drive\path\filename (see below)
  41.     F:                      <- Drive spec for work Directory (or NONE)
  42.     7                       <- Default VIEWPIX configuration (see below)
  43.     456789                  <- Allowable configuration options (see below)
  44.  
  45.     Note : Line #3 above can be set to the following BBS software types:
  46.         
  47.                     GAP  - GAP BBS  (uses DOOR.SYS)
  48.                     PCB  - PCBoard  (uses DOOR.SYS ONLY!)
  49.                        WC3  - Wildcat! v3.x  (uses DOOR.SYS)
  50.                     WWIV - WWIV  (uses CHAIN.TXT)
  51.                     SF   - Spitfire  (uses SFDOORS.DAT)
  52.                     RBBS - RBBS  (uses DORINFOn.DEF)
  53.  
  54.     Note : Lines #5 & #6 above reference two files that are vital to VIEWPIX
  55.            operation. These lines MUST be fully qualified drive\path\filenames.
  56.            Let's examine the contents of these two files.
  57.  
  58.     Note : Lines #8 & #9 refer to the type of graphic that GIFDesk will
  59.            compose.  Here's a rundown:
  60.  
  61.                 #      Grid             Resolution
  62.                 ---------------------------------------
  63.                 1 -> 1 x 1 Grid      640x480 resolution
  64.                 2 -> 1 x 1 Grid      800x600 resolution
  65.                 3 -> 1 x 1 Grid     1024x768 resolution
  66.                 4 -> 2 x 2 Grid      640x480     " "
  67.                 5 -> 2 x 2 Grid      800x600     " "
  68.                 6 -> 2 x 2 Grid     1024x758     " "
  69.                 7 -> 3 x 3 Grid      640x480     " "
  70.                 8 -> 4 x 4 Grid      800x600     " "
  71.                 9 -> 5 x 5 Grid     1024x768     " "
  72.  
  73.     Line #8 is the DEFAULT setup you wish the door to start with.  Users can
  74.     change this to any of the allowable options (1-9) you place on Line #9.
  75.  
  76.         SAMPLE.LST and SAMPLE.DIR contain directory information that VIEWPIX
  77.     uses to find and display the GIF files on your system.
  78.  
  79.         SAMPLE.LST contains the drive\path specs for all directories on your
  80.     system that contain GIF files.  You can have as many specs as you need.
  81.     Just make sure you put ONE SPEC PER LINE and make sure the subdirectories
  82.     actually exist somewhere on your system.
  83.  
  84.         SAMPLE.DIR contains the "header names" of each directory in SAMPLE.LST.
  85.     If you have several directories with various types of GIF files, you can
  86.     place a descriptive name here - again, ONE PER LINE with a number in front
  87.     of it followed by a space.  SAMPLE.LST and SAMPLE.DIR must have the same
  88.     number of lines.
  89.  
  90.         Okay, we're almost there.  Now, all that remains is to create a batch
  91.     file that will run the whole thing.  BBS software differs a bit as to
  92.     where you place the BAT file.  Put it where you would for any other door.
  93.     Here's what VIEWPIX needs to execute.  We'll call it VIEWPIX.BAT.
  94.  
  95.                @echo off            <- My preference
  96.                c:\                  <- Just to be sure
  97.                cd \viewpix          <- Change to door directory
  98.                viewpix viewpix.cnf  <- Run VIEWPIX with config file parameter
  99.                c:\                  <- Just to be sure again
  100.                cd \gap              <- Back to BBS directory
  101.  
  102.         The line above that runs VIEWPIX can have any filename as a parameter.
  103.     Just make sure you have that filename (as in SAMPLE.CNF above) in the
  104.     door directory.  Likewise, the names of the ".LST" and ".DIR" files can
  105.     be anything you choose as long as you tell VIEWPIX in the config file.
  106.  
  107.         That, pretty much, does it!  The door should run now providing you've
  108.     set it up properly.
  109.  
  110.  
  111.     --------------
  112.     Door Operation
  113.     --------------
  114.         Your users are gonna love it!  How many times have you downloaded
  115.     300+ k GIF files only to find that they're really not what you expected?
  116.     That's where VIEWPIX comes to the rescue.  Here's what actually happens.
  117.  
  118.         Users can display file listings of all your GIFs and, depending on
  119.     how they choose to configure VIEWPIX, download and/or view a single
  120.     "preview" GIF file containing the pictures they've selected.  GIFDesk,
  121.     an amazing piece of software, is responsible for making up this "preview"
  122.     GIF file.  VIEWPIX passes filenames to GIFDesk and GIFDesk works it's
  123.     magic.  VIEWPIX then takes the "preview" file, gives it a unique DOS
  124.     filename, and sends it to the user.  If the user has SHOWGIF loaded as a
  125.     TSR, they'll see the graphic as it's being downloaded.  If not, they can
  126.     look at the "preview" afterwards with any GIF viewer.
  127.  
  128.         Before I forget - VIEWPIX also needs DSZ to perform file transfers.
  129.     DSZ from Omen Technologies is a fine protocol package that no sysop should
  130.     be without.  Get it and REGISTER IT!  Make sure it's in your path, too, so
  131.     VIEWPIX can find it.
  132.  
  133.         Back to the door's operation.  VIEWPIX will run locally from within
  134.     your BBS.  Logon locally, go into VIEWPIX, and have it make a preview for
  135.     you.  You won't be able to view the file online, but you will be able to
  136.     store the file in any directory you choose and view it later with your
  137.     favorite GIF viewer.  --- OR --- load up SHOWGIF and give No Anchovies BBS
  138.     a call (see numbers below).
  139.  
  140.  
  141.     -----------
  142.     SysOp Stuff
  143.     -----------
  144.         VIEWPIX is written in QuickBASIC 4.5 using Kenny Gardner's GAPQBDR door
  145.     library.  VIEWPIX has been compiled to "stand alone" and needs no fossil
  146.     driver or runtime library to execute.  As sysop, you have certain function
  147.     keys available to you while users are in VIEWPIX.
  148.  
  149.                     [F5]    <- Shell to DOS ("EXIT" brings you back)
  150.                     [F8]    <- Twit the user back to the BBS
  151.                    [F10]    <- Chat with user (ESC to end chat)
  152.                   [Home]    <- Main user stats in sysop window
  153.                    [End]    <- Displays sysop function keys
  154.                   [PgDn]    <- More user stats
  155.               [Up Arrow]    <- Increase user's remaining time
  156.               [Dn Arrow]    <- Decrease user's remaining time
  157.  
  158.          *********************************************************
  159.          *****   DO NOT ALTER FILES "VIEWPIX" & "VIEWPIXG"   *****
  160.      *****         BOTH HAVE NO FILENAME EXTENSION       *****
  161.          *****    DOING SO WILL RENDER VIEWPIX IN OPERABLE   *****
  162.          *********************************************************
  163.  
  164.  
  165.     ------------
  166.     Registration
  167.     ------------
  168.         VIEWPIX registration is $35.00 payable by check or money order to:
  169.  
  170.                               No Anchovies PC
  171.                               1205 Lake Avenue
  172.                               Ashtabula, OH.  44004
  173.  
  174.         The unregistered demo version will only allow 10 GIF files to display
  175.     in only one directory.
  176.  
  177.         When you register, you'll be given access to the VIEWPIX support forum
  178.     on No Anchovies BBS (216-466-1152 and 1153, both HST Dual Standard).  It
  179.     is here that you will receive a serial number that will register the door.
  180.  
  181.         Any questions, comments, etc. can be addressed in a comment to SYSOP
  182.     on No Anchovies.
  183.     
  184.